Salesforce UX API
TMF-700 [IF 004 & IF 005a-Delivery order] POST-shippingOrder
Return order will be verified against correctness and registered in BlueIQ
URL
https://[localhost]:[port]/dev/sfdc-ux/v1/{businessId}/shippingOrder
url Param
name | type | description | required |
---|---|---|---|
businessId | string | 2 letter ISO 3166 country code (TT, BB, JM, PA, PR etc.) identifying the business unit. Expected one is "PR"-Puerto Rico | Y |
Header
name | type | description | required |
---|---|---|---|
client_id | string | The client_id identifying the channel. | Y |
client_secret | string | Password associated with the client_id. | Y |
X-Correlation-ID | string | An identifier for the current call chain that can be used to tie together log entries on multiple layers (e.g. client, server, mainframe). This identifier must be designed to be unique across all applications. | Y |
cURL request
curl --location 'https://nonprod.esb.cloud.lla.com/dev/sfdc-ux/sfdc-ux/v1/PR/shippingOrder' \
--header 'client_id: 784c9a6dd7ae49768816cab57fcf1fa1' \
--header 'client_secret: 187b259EB77441babbF611d2646C670d' \
--header 'Content-Type: application/json' \
--data-raw '{
"shippingOrderItem": [
{
"id": "R10-Alpha",
"quantity": "1",
"status": "active",
"action": "add",
"shipment": {
"shipmentCharacteristic": [
{
"name": "reservationNo",
"value": "Intgen-lib-1128"
}
]
},
"product": {
"id": "000000000000105154",
"name": "device"
}
}
],
"shippingOrderCharacteristic": [
{
"id": "0",
"name": "Action",
"value": "Delivery",
"valueType": "string"
},
{
"id": "1",
"name": "orderType",
"value": "292"
}
],
"shippingInstruction": {
"signatureRequired": true
},
"relatedShippingOrder": {
"role": "Individual",
"id": "8013K000001dM3CQAU790"
},
"relatedParty": [
{
"@referredType": "Customer",
"role": "Individual",
"name": "Bogasamudram Sravani",
"contactMedium": [
{
"mediumType": "string",
"id": "1",
"characteristic": {
"street2": "345 Calle",
"street1": "345 Calle",
"stateOrProvince": "PR",
"postCode": "00923",
"phoneNumber": "11798364832",
"emailAddress": "jose23@gmail.com",
"country": "US",
"contactType": "Phone;Mail",
"city": "San Juan"
}
}
]
},
{
"name": "Sravani",
"role": "Return",
"@referredType": "Return",
"contactMedium": [
{
"characteristic": {
"street1": "101 Broadway East",
"street2": "Seattle",
"city": "Seattle",
"stateOrProvince": "WA",
"country": "USA",
"postCode": "98109",
"contactType": "Phone;Mail",
"emailAddress": "returnemailid@abc.com"
}
}
]
}
],
"productOrder": {
"id": "8013K000001dM3CQAU"
},
"note": [
{
"text": "string",
"id": "orderNote"
}
],
"status": "active"
}'
Definitions
Each of the request parameters is detailed.
name | type | description | required |
---|---|---|---|
status | string | status of shipping order e.g "active" | N |
note | array | A list of notes made on this shipping shipment | N |
note.id | string | Identifier of the note within its containing entity | N |
note.text | string | Text of the note | N |
productOrder | object | product order | Y |
productOrder.id | string | unique identifier | Y |
shippingOrderCharacteristic.id | string | Unique identifier of the characteristic | Y |
shippingOrderCharacteristic.name | string | Name of the characteristic | Y |
shippingOrderCharacteristic.valueType | string | Data type of the value of the characteristic | Y |
shippingOrderCharacteristic.value | string | value of the characteristic | Y |
relatedParty | object | An existing related party that has some form of correlation with the given shipping order. It can be recipient, payer, etc. | Y |
relatedParty.@referredType | string | unique identifier | Y |
relatedParty.name | string | referredType of the related entity | Y |
relatedParty.role | string | Role played by the related party | N |
relatedParty.contactMedium | object | Indicates the contact medium that could be used to contact the party. | Y |
relatedParty.contactMedium.id | string | unique identifier | N |
relatedParty.contactMedium.mediumType | string | Type of the contact medium, such as: email address, telephone number, postal address | N |
relatedParty.contactMedium.characteristic | object | Describes the contact medium characteristics that could be used to contact a party (an individual or an organization) | Y |
relatedParty.contactMedium.characteristic.emailAddress | string | Full email address in standard format | N |
relatedParty.contactMedium.characteristic.phoneNumber | string | The primary phone number of the contact | N |
relatedParty.contactMedium.characteristic.contactType | string | The type of contact, for example: phone number such as mobile, fixed home, fixed office. postal address such as shipping instalation… | N |
relatedParty.contactMedium.characteristic.street1 | string | Describes the street | Y |
relatedParty.contactMedium.characteristic.street2 | string | Complementary street description | N |
relatedParty.contactMedium.characteristic.city | string | The city | Y |
relatedParty.contactMedium.characteristic.stateOrProvince | string | State or province | Y |
relatedParty.contactMedium.characteristic.country | string | The country | Y |
relatedParty.contactMedium.characteristic.postCode | string | Postcode | Y |
relatedShippingOrder | object | An existing shipping order that has some form of correlation with the given shipping order | Y |
relatedShippingOrder.id | string | unique identifier | Y |
relatedShippingOrder.role | string | The role of an entity. | Y |
shippingOrderItem | array | A list of shipping order items. Each shipping order item has a corresponding Shipment(e.g. parcel) which has one or multiple products in it | Y |
shippingOrderItem.action | string | The action to be carried out on the Product. Can be: add, modify, delete, noChange | N |
shippingOrderItem.id | string | Identifier of the Shipping Order Item | Y |
shippingOrderItem.quantity | string | Quantity the individual shipment line item | Y |
shippingOrderItem.status | string | status of shipping order item. e.g "active" , "savedForLater" | N |
shippingOrderItem.product.id | string | Material Number an unique identifier | Y |
shippingOrderItem.product.name | string | name of the product | Y |
shippingOrderItem.shipment | object | A set of goods to be shipped | Y |
shippingOrderItem.shipment.shipmentCharacteristic.name | string | Name of the related entity | Y |
shippingOrderItem.shipment.shipmentCharacteristic.value | string | The value of the characteristic | Y |
[ 200 ]
OK Created - request successful, has been created. Response body may contain an entity corresponding to the created resource.
{
"id": "2127770"
}
Definitions
name | type | description | required |
---|---|---|---|
id | String | ID created on repository side | Y |